home *** CD-ROM | disk | FTP | other *** search
/ The Latest & Greatest Top 201 Games / The Latest and Greatest Top 201 Games (Maple Media)(1994).iso / cwbs23 / cs.doc < prev    next >
Text File  |  1993-06-20  |  21KB  |  405 lines

  1.                       CIVILSET v2.2 - EGA Scenario Editor
  2.  
  3.       ╔══════════════════╗
  4.       ║ 1.0 Introduction ╟─────────────────────────────────────────────────────
  5.       ╚══════════════════╝
  6.      CIVILSET allows you to create, modify, and save battle scenarios
  7.      for the EGA version of CIVILWAR BATTLESET. A scenario is a
  8.      combination of battle map (with terrain features and battlefield
  9.      objective),armies, and description. Scenarios (xxx.CIV) files are
  10.      saved as "flat" ASCII files and with  practice you may choose to
  11.      use a word processor or text editor to directly modify the files.
  12.  
  13.      There is no longer a catalog file requirement, which eliminates the
  14.      need for the DOS SORT routine. An option has been added to allow
  15.      you to change the directory and drives. The number of scenarios in
  16.      a directory is no longer restricted to 20. File error handling has
  17.      been improved.
  18.  
  19.      The scenario files now allow up to 40 units per side. The game
  20.      program MUST have all files in the new format. If you have any
  21.      files developed in the old format, you MUST convert them to the new
  22.      format before using them. (See Section 9 below).
  23.  
  24.      The editor requires the following files:
  25.          TERRAIN.EGA ─┐
  26.          STDICON.EGA ─┼ Icon Files MUST be present
  27.             MISC.EGA ─┘
  28.            UNION.LDR - 15 prominent Union leaders and ability ratings*
  29.            REBEL.LDR - 15 prominent Rebel leaders and ability ratings*
  30.           MONTHS.DAT - dates for random scenarios
  31.          PNAMES1.DAT - place names for random scenarios
  32.          PNAMES2.DAT - place names for random scenarios
  33.           RNAMES.DAT - Rebel unit names for random scenarios
  34.           YNAMES.DAT - Union unit names for random scenarios
  35.  
  36.    * The two *.LDR files are simple ASCII files and can be modified with
  37.      a text editor. The only requirement is that the total number of
  38.      leaders in each file MUST be 15 and that the each individual entry
  39.      is in the format:
  40.  
  41.      "leader name",ability #
  42.  
  43.      The leader name can be no more than 16 characters. The leadership
  44.      ability score must be in the range of 10-110.
  45.  
  46.       ╔═══════════════╗
  47.       ║ 2.0 Main Menu ╟───────────────────────────────────────────────────────
  48.       ╚═══════════════╝
  49.  
  50.          ╔════════════════════════╗
  51.          ║         Options        ║
  52.          ╠════════════════════════╣
  53.          ║ Initial Scenario       ║
  54.          ║ Menu Scenario Load     ║
  55.          ║ Manual Scenario Load   ║
  56.          ║ Save Scenario          ║
  57.          ║ MAP Edit               ║
  58.          ║ ARMY Edit              ║
  59.          ║ Description            ║
  60.          ║ Briefing               ║
  61.          ║ [ convert old format ] ║
  62.          ║ Directory C:\CIVIL17   ║
  63.          ║ Random Scenario        ║
  64.          ║ Quit                   ║
  65.          ╚════════════════════════╝
  66.  
  67.       ╔══════════════════════╗
  68.       ║ 3.0 Initial Scenario ╟─────────────────────────────────────────────────
  69.       ╚══════════════════════╝
  70.      This option zeros all army units and provides a blank game map (all
  71.      'clear' hexes). Use it to create entirely new scenarios.
  72.      
  73.       ╔════════════════════════╗
  74.       ║ 4.0 Menu Scenario Load ╟───────────────────────────────────────────────
  75.       ╚════════════════════════╝
  76.      This option provides you with a list (up to 20) of the xxx.CIV
  77.      battle scenario files that are on the current directory, to allow
  78.      you to select one to load. File selection is done via menu, by
  79.      moving the cursor up or down with the "arrow keys" on the key pad,
  80.      then pressing "Enter" to make a selection of the hilighted item.
  81.      
  82.       ╔══════════════════════════╗
  83.       ║ 5.0 Manual Scenario Load ╟─────────────────────────────────────────────
  84.       ╚══════════════════════════╝
  85.      This option allows you to load a file from the list of files
  86.      displayed on the screen. This list will show all the xxx.CIV
  87.      scenarios on the current directory and drive. This option allows
  88.      you to access more than the 20 files that can be accessed using the
  89.      menu. To select a file, simply type the file name and press
  90.      "Enter". Note that you omit the ".CIV" extender, it is
  91.      automatically included.
  92.  
  93.       ╔═══════════════════╗
  94.       ║ 6.0 Save Scenario ╟────────────────────────────────────────────────────
  95.       ╚═══════════════════╝
  96.      Before saving the file, you will be prompted to provide the battle
  97.      name and time limit (Section 2.7) if you have not already done so.
  98.      You will also be prompted for the file name (1-8 characters
  99.      identifying the file on the directory). If you use a name already
  100.      in use, the old file will be overwritten. YOU DO NOT NEED TO
  101.      PROVIDE THE ".CIV" EXTENDER. Messages will advise you of the status
  102.      of the file save.
  103.  
  104.  
  105.       ╔══════════════╗
  106.       ║ 7.0 MAP Edit ╟─────────────────────────────────────────────────────────
  107.       ╚══════════════╝
  108.      This option allows you to move the cursor across the battle map to
  109.      place the terrain features. To select a feature, type the letter of
  110.      the feature desired (upper or lower case). Then, move the cursor
  111.      (arrow keys) to the desired position and press 'Enter'.
  112.  
  113.      You will see a raised "button" on the right hand side of the
  114.      screen. If you press 'D' (for 'Duplicate') while a given feature is
  115.      under the cursor, the button will be depressed, meaning the
  116.      selected feature will be duplicated wherever the cursor is moved.
  117.      Pressing 'D' again will toggle the 'Duplicate' feature off. This
  118.      'Duplicate' mode allows you to quickly draw large repetitive map
  119.      features.
  120.  
  121.         ╔═══════════════════════════════════════════════════════════╗
  122.         ║  NOTE: The scenario will not work properly unless it has  ║
  123.         ║        EXACTLY 1 objective.                               ║
  124.         ╚═══════════════════════════════════════════════════════════╝
  125.      
  126.      Placing a terrain feature over an army unit causes the army to no
  127.      longer be visible. Press 'A' to make armies visible again. Use the
  128.      F10 key to return to the initial menu when you have finished
  129.      editing your map.
  130.  
  131.       ╔═══════════════╗
  132.       ║ 8.0 ARMY Edit ╟────────────────────────────────────────────────────────
  133.       ╚═══════════════╝
  134.      In the army editor You may add new units, edit existing units, or
  135.      remove existing units.
  136.  
  137.      You will see to the right 2 buttons, a "U" (for Union) and an "R"
  138.      (for Rebel). One button will be depressed, the other raised. The
  139.      depressed button is for the side currently being placed. Pressing
  140.      the other button toggles to the other side.
  141.  
  142.      You will also see a window with the letters of the available 'hot
  143.      keys'. This will read 'I A E H N C G B' if the cursor is not over an
  144.      army unit. It will read 'D E L M P S T Z' if the cursor is over an
  145.      army unit. For instance, if the cursor is not over an existing
  146.      unit, pressing 'C' will place a cavalry unit at the position of the
  147.      cursor. The complete list of editor 'hot keys' show below can be
  148.      accessed by the help menu (F1 key). Also, a status line is provided
  149.      to show unit information by passing the cursor over a unit.
  150.      
  151.      8.1 Add New Unit (Hot Key)
  152.      ──────────────────────────
  153.      A unit placed will be for the side currently selected. If you use a
  154.      hot key, the unit type selected is immediately placed at the cursor
  155.      position.
  156.  
  157.         ╔═══════════════════════════════════════════════════════════════╗
  158.         ║ A            place rifled ARTILLERY unit at cursor            ║
  159.         ║ B            place gun BOAT unit at cursor (must be water hex)║
  160.         ║ C            place CAVALRY unit at cursor                     ║
  161.         ║ E            place EMPLACED GUN at cursor                     ║
  162.         ║ G            place GENERAL unit at cursor                     ║
  163.         ║ H            place HORSE artillery unit at cursor             ║
  164.         ║ I            place INFANTRY unit at cursor                    ║
  165.         ║ N            place NAPOLEON (smooth bore) artillery at cursor ║
  166.         ║ R            toggle to place Rebel armies                     ║
  167.         ║ U            toggle to place Union armies                     ║
  168.         ╚═══════════════════════════════════════════════════════════════╝
  169.  
  170.      8.2 Add New Unit (Menu)
  171.      ───────────────────────
  172.      Otherwise, you may press' Enter' to pop up an menu that will allow
  173.      you to select the unit type.
  174.  
  175.      You will be prompted to enter the name of the unit. If you hit
  176.      'Enter' a menu will appear listing the names and abilities of 15
  177.      prominent leaders for the side being placed. If select one of these
  178.      leaders, the name and associated morale/leadership values is
  179.      automatically assigned to the unit. If you press 'Esc' you are
  180.      returned to the option of providing your own name. If you assign
  181.      your own name, the morale/leadership values will initially be set
  182.      at default values.
  183.      
  184.      After you enter the desired name, press 'Enter' and the unit will
  185.      be placed. If you wish to modify any of the unit attributes, you
  186.      must edit the unit as described below.
  187.                                                                  
  188.      Each side has a maximum of 40 units available for positioning.
  189.      There is no restriction on number of units of a given type. The
  190.      current number of units of each type and total strength of all
  191.      units is shown for each side as units are placed or edited. Also,
  192.      the ratio of total Union strength to total Rebel strength is shown.
  193.                                                                  
  194.      The menu also provides a screen redraw feature.
  195.  
  196.      8.3. Edit Existing Unit (Hot Key)
  197.      ─────────────────────────────────
  198.      To edit a unit using the hot keys, place the cursor over the unit
  199.      and press the appropriate key:
  200.  
  201.          ╔═════════════════════════════════════════════════════════╗
  202.          ║  D            DELAY unit                                ║
  203.          ║  L            modify unit's LEADERSHIP factor           ║
  204.          ║  M            modify unit's MORALE factor               ║
  205.          ║  P            move unit to a new POSITION               ║
  206.          ║  S            modify unit's STRENGTH                    ║
  207.          ║  T            change a unit's TYPE (I A E H N C G B)    ║
  208.          ║  Z            ZAP unit at cursor                        ║
  209.          ║  !            UNzap last unit zapped                    ║
  210.          ║  (return)     EDIT unit (bring up menu)                 ║
  211.          ╚═════════════════════════════════════════════════════════╝
  212.  
  213.      The effect of these keys is described in the sections below.
  214.                                                                  
  215.      8.4 Edit Existing Unit (Menu)
  216.      ─────────────────────────────
  217.      To edit a unit,move the cursor to the unit and press        
  218.      'Enter'. You will be given the option to edit the unit.     
  219.      When you elect to edit, a window will be displayed with the 
  220.      unit characteristics:
  221.  
  222.         ╔═══════════════════════════════════════════════════════════════╗
  223.         ║    side and number   Rebels numbered  1-40                    ║
  224.         ║                      Union numbered  41-80                    ║
  225.         ╠═══════════════════════════════════════════════════════════════╣
  226.         ║    strength           defaults:                               ║
  227.         ║                      750 for infantry                         ║
  228.         ║                      500 for cavalry                          ║
  229.         ║                      300 for artillery, boats and Napoleons   ║
  230.         ║                      100 for horse artillery                  ║
  231.         ║                      200 for general                          ║
  232.         ╠═══════════════════════════════════════════════════════════════╣
  233.         ║    morale            (default is 80)                          ║
  234.         ╠═══════════════════════════════════════════════════════════════╣
  235.         ║    leadership        (default is 80)                          ║
  236.         ╠═══════════════════════════════════════════════════════════════╣
  237.         ║    unit name                                                  ║
  238.         ╠═══════════════════════════════════════════════════════════════╣
  239.         ║    time delay        if shown with an *, the unit is NOT on   ║
  240.         ║    before first      field until time delay is elapsed.       ║
  241.         ║    action            (default is 0)                           ║
  242.         ╠═══════════════════════════════════════════════════════════════╣
  243.         ║    entrenchment      Message if unit is entrenched            ║
  244.         ╚═══════════════════════════════════════════════════════════════╝
  245.  
  246.      To change an attribute, select the desired characteristic from 
  247.      the menu. Strength, morale, and leadership are increased or
  248.      decreased by pressing the 'up' and 'down' arrow keys respectively
  249.      (following instructions on  screen).
  250.  
  251.      Unit name may be changed by typing in a new name at the prompt.
  252.      You cannot change the unit's side; if unit placed is for wrong side,
  253.      first delete it, then toggle to the other side, and place the new
  254.      unit.
  255.  
  256.      Pressing the 'escape' key will cancel the edit and close the
  257.      edit menu.
  258.  
  259.      
  260.      8.5    { D } - Delay Unit
  261.      ──────────────────────
  262.      When specifying a 'Delay' for units, you are given the option to
  263.      have the delayed unit either a) be off the screen until the
  264.      specified delay has elapsed (default option) or b) be on screen but
  265.      simply inactive. When examining a unit, a '*'next to the 'Dly'
  266.      value indicates the unit will be OFF SCREEN until the delay
  267.      elapses. Units that are OFF SCREEN will be shown by a blank colored
  268.      box instead of the normal icon.
  269.      
  270.      For example:
  271.        *Dly : 5  means that the unit under the cursor will not        
  272.                  appear until 5 turns have elapsed. After that time, the
  273.                  unit will arrive at the battle as soon as the location
  274.                  at the cursor is not occupied by another army.
  275.         
  276.         Dly : 15 means the unit under the cursor will be on the map but
  277.                  inactive until 15 turns elapse.
  278.                                                                  
  279.      8.6    { E } - Entrench Unit
  280.      ─────────────────────────
  281.      Units can be 'entrenched' using the editor. Computer-controlled
  282.      units that are entrenched at the beginning of a scenario will hold
  283.      their position during the game. Human-controlled units that are
  284.      entrenched at the beginning of a scenario may refuse to leave
  285.      entrenchments (if leadership/morale is low). Even if units follow
  286.      orders to leave entrenchments, they require extra time to do so.
  287.      Once units are un-entrenched, they cannot be re-entrenched in the
  288.      game (though you COULD save the game and re-entrench using the
  289.      editor). While entrenched, units will fight at a bonus (in addition
  290.      to any terrain bonus) if attacked. Entrenched artillery units will
  291.      still fire, but are receive the entrenchment defensive bonus.
  292.  
  293.      8.7.    { L } - Modify Unit Leadership
  294.      ─────────────────────────────────────
  295.      Use up/down arrow keys to change leadership in range of 10-110.
  296.      Higher numbers reflect better leadership.
  297.  
  298.      8.8.    { M } - Modify Unit Morale
  299.      ───────────────────────────────
  300.      Use up/down arrow keys to change morale in range of 10-110.
  301.      Higher numbers reflect better morale.
  302.  
  303.      8.9.    { P } - Move Unit to New Position
  304.      ──────────────────────────────────────
  305.      Existing units can now be repositioned by pressing 'P' when the
  306.      cursor is over the desired unit. The move the cursor to the new
  307.      location, and press 'Enter' to move the unit. This feature is not
  308.      available in the Edit menu.
  309.  
  310.      8.10.    { S } - Modify Unit Strength
  311.      ──────────────────────────────────
  312.      Use up/down arrow keys to change the unit' strength. Maximum
  313.      strength for artillery units is 1000; for other units it is 3000.
  314.  
  315.      8.11    { Z } - Zap Unit
  316.      ─────────────────────
  317.      Using the hot key 'Z' or selecting the 'ZAP UNIT' option from
  318.      the edit window will remove the unit. This is useful to remove
  319.      incorrect units.
  320.  
  321.      8.11    { ! } - UNZap Unit
  322.      ───────────────────────
  323.      If you accidentally Zapped a unit and HAVE NOT YET PLACED A NEW
  324.      UNIT, an exclamation mark ('!') will appear in the window of
  325.      available options. Pressing '!' will restore the unit Zapped at the
  326.      cursor. (The unit recalled is the LAST unit Zapped). If the
  327.      exclamation mark does not show in the window, you cannot recover
  328.      the Zapped unit.
  329.  
  330.      8.12    { T } - Change Unit Type
  331.      ─────────────────────────────
  332.      When the cursor is over a unit, you may change the unit type by
  333.      first pressing 'T', then responding to the prompt to enter the
  334.      first letter of the unit type. All the other unit attributes will
  335.      remain the same, except that artillery type units will be
  336.      restricted to a maximum strength of 1000.
  337.  
  338.       ╔═════════════════╗
  339.       ║ 9.0 Description ╟──────────────────────────────────────────────────────
  340.       ╚═════════════════╝
  341.      The scenario description includes the battle name text that appears
  342.      at the top of the game screen, and the time limit (number of turns)
  343.      for the scenario. NOTE: the battle name text description is simply
  344.      a title line, and NOT the file name). DO NOT USE COMMAS. A
  345.      suggestion is to use the battle name and historical date.
  346.                                                                     
  347.      You must also select a time limit (number of turns) for the
  348.      scenario. This sets a limit on how long the scenario will last.
  349.  
  350.       ╔═════════════════╗
  351.       ║ 10.0 Briefing   ╟──────────────────────────────────────────────────────
  352.       ╚═════════════════╝
  353.      The scenario briefing consists of up to 22 lines of text which is
  354.      available on-line when the game itself is played. You will be
  355.      prompted for then scenario briefing, which should give a synopsis
  356.      of the battle along with any particular battle problems or
  357.      pecularities you might want to call to attention. When you have
  358.      finished, pressing the 'Esc' key will return you to the main menu.
  359.  
  360.       ╔═══════════════════════════╗
  361.       ║ 11.0 [convert old format] ╟────────────────────────────────────────────
  362.       ╚═══════════════════════════╝
  363.      Use this option to read OLD FORMAT files created with previous
  364.      versions of CIVILWAR BATTLESET. Then SAVE file as described in
  365.      Section 2.4 above. The following procedure is suggested:
  366.  
  367.         a) Make a back up copy of your old scenario (just in case...)
  368.         b) Load the old scenario using the 'convert old format' option.
  369.            (Do NOT use the 'Load Saved Scenario' option or an error 
  370.            will result).
  371.         c) Save the scenario under the 'Save Scenario' option. It can
  372.            now be loaded using the 'Load Scenario' option.
  373.  
  374.       ╔════════════════╗
  375.       ║ 12.0 Directory ╟───────────────────────────────────────────────────────
  376.       ╚════════════════╝
  377.      With this option you may change the directory used by the program
  378.      for loading and saving files. Simply type the new path over the old
  379.      one that is displayed in the colored box, then press "Enter". If
  380.      the new directory is valid, it will be displayed when the main menu
  381.      returns. Otherwise an error message is displayed, and the old
  382.      directory is retained.
  383.  
  384.       ╔══════════════════════╗
  385.       ║ 13.0 Random Scenario ╟──────────────────────────────────────────────────
  386.       ╚══════════════════════╝
  387.      This option allows you to quickly generate random scenarios. In
  388.      doing this, you will be asked first for the battle size (ranging
  389.      from a minor skirmish involving only a few units) to very large
  390.      'epic' battle with the maximum number of units. You can also
  391.      control the balance of the battle, from a strong Union advantage
  392.      (++ Union) to a strong Rebel advantage (++ Rebel). The program will
  393.      automatically create the map, place the armies and the objective.
  394.      The battle will also be given a fictitious place name and date. If
  395.      you like how the battle looks, return to the Main Menu to save it
  396.      (the default name will be 'RANDOM.CIV'. Of course, you may edit the
  397.      map or army to modify the random scenario to suit your taste.
  398.  
  399.       ╔══════════╗
  400.       ║ 14. Quit ╟──────────────────────────────────────────────────────────────
  401.       ╚══════════╝
  402.      Allows you to exit the program. Be sure you have saved all your
  403.      work first.
  404.  
  405.